# Rusted Warfare v2.7.3 - 原生IME支持版

**CQFISH&喵酱出品**

## 📝 版本信息

- **版本号**：v2.7.3 - 原生IME支持版
- **发布日期**：2026年8月27日 21:28
- **主要功能**：原生Windows输入法支持
- **技术架构**：WH_GETMESSAGE钩子 + JNA Windows API集成

## 🎯 核心功能

### 原生IME中文输入
- ✅ 支持搜狗拼音、微软拼音、百度拼音等主流输入法
- ✅ 与Windows系统原生输入体验完全一致
- ✅ 智能候选框定位（游戏窗口中心）
- ✅ 实时预览和候选词选择

### 全面游戏场景支持
- ✅ 聊天系统中文输入
- ✅ 房间命名中文支持
- ✅ 设置界面中文输入
- ✅ MOD管理中文描述

## 🔧 技术实现

### 架构设计
采用**WH_GETMESSAGE钩子技术**实现系统级消息拦截：

```java
// 核心钩子实现
private static LRESULT getMessageHook(int nCode, WPARAM wParam, LPARAM lParam) {
    // 拦截WM_IME_STARTCOMPOSITION、WM_IME_COMPOSITION、WM_IME_CHAR
    // 处理中文输入并注入到LibRocket UI系统
}
```

### 技术栈
- **JNA**：Java Native Access 调用Windows API
- **Hook技术**：WH_GETMESSAGE全局钩子消息拦截
- **LibRocket集成**：直接注入字符到UI系统
- **IME API**：Windows输入法接口深度集成

## 📦 文件清单

```
build/20260827_212816/
├── Rusted Warfare v2.7.3 - 原生IME支持版.jar    # 主游戏文件
├── game-lib-patched.jar                         # 修补后的库文件
├── IMESupport.java                              # 中文输入支持源码
└── README.md                                    # 版本说明文档
```

## 🚀 使用指南

### 1. 启动游戏
运行主程序："Rusted Warfare v2.7.3 - 原生IME支持版.jar"

### 2. 输入中文
- 点击需要输入文本的界面元素
- 切换到中文输入法（如搜狗拼音）
- 直接输入中文，候选框会显示在游戏窗口中心
- 使用数字键选择候选词

### 3. 功能验证
- 在聊天框输入测试中文
- 在创建房间时输入中文房间名
- 在设置界面输入中文内容

## ⚙️ 技术特性

### 性能优化
- 线程级钩子设计，减少系统开销
- IMC上下文缓存机制，避免重复获取
- 优化的消息处理逻辑，低延迟响应

### 兼容性
- ✅ Windows 10/11 完全兼容
- ✅ 支持所有主流中文输入法
- ✅ 兼容游戏原有的所有功能

### 稳定性
- 异常处理完善，崩溃防护
- 资源管理优化，内存泄露防护
- 日志系统完善，问题排查方便

## 🔍 故障排除

### 常见问题
1. **输入法无响应**
   - 确认输入法正确安装
   - 尝试以管理员身份运行游戏
   - 检查系统语言设置

2. **候选框位置异常**
   - 系统自动定位到窗口中心
   - 特殊UI布局会自动调整

3. **无法输入中文**
   - 确保焦点在输入框内
   - 检查输入法是否激活
   - 尝试切换输入法

### 日志分析
游戏控制台会输出详细的输入法日志，格式：
```
[IME] Hook IME msg=0x10D wParam=0x0 lParam=0x0
[IME] WM_IME_STARTCOMPOSITION
[IME] IME result: 你好 (len=2)
[IME] injectText: injected 2 chars
```

## 📈 版本升级

### 从旧版本升级
1. 备份旧版本游戏文件
2. 替换新的 jar 文件
3. 无需重新配置，保持原有设置

### 版本兼容
- 完全兼容现有模组和地图
- 支持所有原有的游戏功能
- 不影响网络对战体验

## 🎉 新体验亮点

### 输入体验
- 如同在记事本中输入一样流畅
- 候选框智能避让游戏界面元素
- 支持实时预览和快速选择

### 技术突破
- 首次实现原生Windows输入法集成
- 消息级拦截，确保输入实时性
- 深度系统级优化，性能优异

### 用户体验
- 无需学习成本，即装即用
- 支持所有中文输入法
- 完美的字符显示效果

---

**CQFISH&喵酱出品 - 让中文游戏更简单！**